home *** CD-ROM | disk | FTP | other *** search
/ HamCall (October 1991) / HamCall (Whitehall Publishing)(1991).bin / bcast / miscbcst / stlsit.doc < prev    next >
INI File  |  1990-10-14  |  4KB  |  87 lines
  1. [STLSITE.DOC]
  2.  
  3.      This is the documentation for STLSITE.BAS.
  4.  
  5.  
  6.      STLSITE.BAS is an IBM Compatible Pc program which calculates
  7. a set of statistics, like an FM channel study, on an STL database
  8. for a given locality.  The demonstration STL database is file
  9. WBSCR.STL and the output file for a site study using it is WBSCR.OUT.
  10.  
  11.      The program is a companion to my article:
  12. Planning an STL System in the October 1988 issue of
  13. BROADCAST ENGINEERING.  See it for more information on the use
  14. and basis for the program.
  15.  
  16.      STLSITE.BAS is a calculator style program that requires
  17. a working knowledge Ms-dos at the system level.  The use of EDLIN to create and
  18. maintain the STL database file (It calculates line by line using the data
  19. in the STL file.) and the manipulation of files at the Dos level.  For each
  20. frequency and STL system in the database, it calculates the transmit
  21. azimuth (bearing) and the distance to the receive site for each system,
  22. the bearing and distance to the proposed STL receive site, and the
  23. line-of-sight clear path loss to it.
  24.  
  25.      Due to the many variables that can influence the usefulness of the STL
  26. frequencies, it performs no selection.  It just calculates a set of STL
  27. database statistics that can be used for finding a frequency or verifying a
  28. recommended one.  Due to the many radio marketplace variables, that's best done
  29. using a mix of the intuitive and the obvious.  See the article for information
  30. on things that affect the frequency selection and use criteria.
  31.  
  32.  
  33. HOW TO USE AND HOW IT WORKS:
  34.  
  35.      To use you need an database file created with EDLIN.  Refer to the
  36. demonstration database file WBSCR.STL.  The first line of the file identifies
  37. the locality.  Following this, each line represents one file record---one
  38. for each frequency.  Each record, from right to left:  Frequency, Station,
  39. STL/TSL, Polarization, then transmit latitude and longitude, followed by
  40. receive latitude and longitude.  The program uses coordinates to calculate
  41. the azimuths (bearings) and the distances, and it expects to find them
  42. at fixed locations in each record:
  43. Transmit latitude beginning at position 25 (program line 315);
  44. transmit longitude beginning at 32 (line 320);
  45. receive latitude beginning at position 40 (line 321);
  46. and receive longitude at 47 (line 330).
  47. The program error tests for 0 only.  It assumes data at those locations in each
  48. record are valid geographical coordinates and the accuracy of the
  49. statistics depend on that.
  50.  
  51.      To use the program, enter the database file name.  If it's not found
  52. the program errors out to Basic.  If found then the program prompts for the
  53. coordinates of the STL site.  Enter on one line in the format: DDMMSS/DDMMSS.
  54. The / delimits the latitude from the longitude for the program.  An error, 0
  55. or no /, restarts the program form the top.  In a minute or so, providing
  56. there were no errors in the database file the STLSITE recalculates the
  57. database and writes it to a file using the same name as the database but with
  58. an extension of .OUT.  The DOS prompt appears when it's done.  Use the TYPE
  59. command to see, or print the STL Channel study for the STL site.
  60.  
  61.  
  62. ABOUT THE PROGRAM:
  63.  
  64.      Lines 100-150 prompt for the STL database file name and the coordinates
  65. of the proposed STL site.  Lines 200-250 opens both files.  Lines 300-360 read
  66. the record, convert the coordinates to decimal degrees and compute the bearing
  67. and distance for the system.  Lines 400-445 computes the same using the
  68. proposed STL site for the receive location.  Line 450 is the bottom of
  69. this program loop which terminates when it detects an EOF (end of file).  Lines
  70. 5000-7050 is the distance and bearing subroutine.  It uses the FCC's 73.208
  71. algorithm.  Lines 8000-8030 is the subroutine which converts the
  72. coordinates to decimal degrees for calculations.  And, lines 8050 is the
  73. program's file error trap.  On an error in the file's record, it displays the
  74. record, and then returns to DOS.  Then, use EDLIN to fix the file and try
  75. again.
  76.  
  77.  
  78. THERE'S HELP:
  79.  
  80.      I will provide a limited amount of support, by mail, for anyone having
  81. problems or comments on the program.  You can reach me at my home address:
  82.  
  83.      Ronald F. Balonis
  84.      118 Rice Street
  85.      Trucksville, PA  18708
  86.  
  87.